我把 Obsidian 笔记变成了一个网站

白胡子 2026年6月3日 19:28

我之前做的竞品分析知识库，积累了几十份监测简报，全在本地的 Obsidian 里。

有一天领导问我能不能发个链接，让他直接在手机上看。我发现我做不到。那些文档只活在我电脑上，发出去是一堆看不了的.md 文件。

所以我决定把它们搬上网。

我以为只要"上传文件"

一开始我对这件事的理解很朴素：把文件放到某个服务器上，别人就能访问了。

听说 GitHub 可以免费托管静态网站，我去查了一下，叫 GitHub Pages，看起来不复杂。我以为把文件放上去就够了，但我连「放上去」这一步都不会。

第一个拦路虎是 Git。

我连 Git 是什么都说不清楚，只知道程序员都在用，跟"代码管理"有关。查了一圈之后我才搞明白，Git 是你电脑和 GitHub 之间传输代码的工具，GitHub Pages 本质上就是把你的文件放在 GitHub 的服务器上，然后给你一个公开的 URL。

没有"启动服务"，没有"配置后端"，就是静态文件直接对外提供，它本身就是服务器。

这个认知让我松了口气，我的站点是纯静态的（HTML + CSS + JS），不需要任何后端逻辑，GitHub Pages 完全够用。

流程拆下来其实就三步：本地准备 → 推到 GitHub → 开启 Pages。

本地这边，先装 Git，然后进到站点文件夹，跑几行命令：

git initgit add .git commit -m "初始版本"

GitHub 那边新建一个仓库（必须选公开，免费账号的私有仓库不能开 Pages），把本地代码推过去，再去 Settings → Pages，选好分支，等一两分钟，链接就出来了：

https://你的用户名.github.io/仓库名/

看到链接真的能打开了，还是挺开心的。

默认链接是 xxx.github.io/...这种格式，能用，但不够干净。我多年前买了个域名，一直没怎么用，这次正好派上场。

问题是，我不记得在哪儿买的了。

后来翻了邮件订单，才确认是在阿里云。域名已经过期，进了赎回期。好在还在赎回期内。

拿回域名之后，下一关是 DNS 解析配置。我以为就是填一个 CNAME 指向 mygithub.github.io ，但 AI 告诉我： 根域名不能用 CNAME，这是 DNS 协议的硬性限制。

根域名（就是 mydomain.com 这种没有前缀的）只能用 A 记录，指向 GitHub 提供的四个固定 IP 之一（185.199.108.153 等）。带 www 的子域名才能用 CNAME 指向 mygithub.github.io 。

我之前一直把这两个搞混了。

阿里云操作完之后，回到 GitHub，Settings → Pages → Custom domain，填上 mydomain.com ，等 DNS 验证通过，勾选 Enforce HTTPS，完成。

配置完第一个域名跑通之后，我想把竞品分析站点也挂到子域名上，比如 comp.mydomain.com 。

流程很直接：阿里云加一条 CNAME（主机记录 comp ，指向 mygithub.github.io ），对应仓库的 Pages 设置填 comp.mydomain.com ，仓库根目录放一个 CNAME 文件（内容就是 comp.mydomain.com ）。

但有一个地方差点踩坑：我用 MkDocs 构建站点，每次构建会清空 site/ 目录重新生成。如果 CNAME 文件只放在仓库根目录，没有跟着一起进 site/ ——下次构建后，GitHub Pages 就会丢失自定义域名的映射，一切回到起点。

CNAME 文件要跟着构建产物走，不能只放在外面。

还有一个坑，GitHub 显示「DNS check successful」，但浏览器访问 comp.mydomain.com 打不开。

反复检查了一遍配置，没有问题，后来用手机流量试了一下，能打开。

原来是本地 DNS 缓存的问题，解析更新了，但我的网络环境还在用旧记录。等几分钟时间，或者换个网络，自然就好了。

下次遇到这种情况，先换个网络或用无痕模式试试，别一上来就怀疑配置错了。

以后新增项目，只需要在阿里云加一条 CNAME、新仓库配一下 Pages，链接就能独立起来。一个域名，后面挂什么都行。

把笔记搬上网的目的达到了，但搬的过程里我发现一个新问题：那些 Markdown 文件，上了网之后，不一定还是你以为的样子。

下一篇聊聊 Obsidian 笔记和网站之间的格式转换坑，这比搭站点本身更折腾。

AI 转型实录 · 目录

继续滑动看下一个

白胡子的AI修行录

向上滑动看下一个